SEARCH.EXE VERSION 1.20A03 Written By Robert Thivierge SEARCH.EXE is a freeware Windows 3.1 program that produces HTML Web pages consisting of small in-line GIF images. These images can be clicked on in a Web browser (like Netscape or Mosaic) to see the full sized JPEG picture. The output can be customized to suit your tastes. _________________________________________________________________ For an up to date version of this document please refer to: http://www.canuck.com/~thivier1/search.html To be mailed mailed future update information related to SEARCH.EXE, send me mail at: thivier1@freenet.calgary.ab.ca or thivier1@canuck.com Table of Contents * SEARCH.EXE News * Current Features * Planned Features * Program Stability * Obtaining the Program * Legal Issues and Credits + Ownership + Freeware Status + Credits + Disclaimer * System Requirements * Installation Procedures * A Picture of SEARCH.EXE * Known Bugs * Contacting the Author SEARCH.EXE News Version 1.20 is a significant upgrade from 1.10. All the HTML text produced can be controlled by you. The default output is now in HTML tables. You still don't need to know HTML to use SEARCH.EXE. However, if you wish to customize the output you will need to know HTML. You can also use SEARCH.EXE to to give a breakdown on disk space used by your JPEG files. All required information on how to use SEARCH.EXE is available by normal Windows on-line help included with the program. Just select one of the Help pull-down menu options. Current Features WEB FEATURES * For every JPEG file in your site, it creates a smaller GIF version. * It generates one or more HTML files which contain links to these pictures. If you choose to have a sophisticated multi-page site (which you don't have to) a browser of your site will be able to traverse through all the pages by following links. * Your site can have one more pages in any directory and any number (zero, one, or many) sub-directories and any level of sub-directories. * You can have SEARCH.EXE organize pictures in different pages based on the file name or comments which are contained within the JPEG file. You can use this feature in combination with sub-directories or without sub-directories. * You can have SEARCH.EXE automatically generate a layout for your pictures with the "AutoOrg" button. It recognizes repeated file name patterns (ie. cc01.jpg, cc02.jpg, etc...), and groups them for you. Optionally you can edit this default layout. * New - All text outputted in pages can be changed. You can make changes globally that effect all pages, make changes that effect a certain type of page, make changes that effect only a particular directory, or effect only a particular page. You can also specify certain text to go next to individual pictures. For instance, next to a photo you could have the title of the photo and the name of the person (or object) in the photo. The text you specify may contain any HTML tags you wish. Pretty much, anything that can be done in HTML can be done with SEARCH.EXE. * New - You can have any number of pictures appear on a row in a table. * New - You can control the display width and height of images. SEARCH.EXE (by default) uses the WIDTH and HEIGHT tag to tell the browser the dimensions of a picture. This speeds up the display of your page for browser users. * New - Support for the new progressive-JPEG file format. Progressive-JPEG files take less disk space and have a fade in effect when viewed by Netscape. You can make your own with the JPEG Utilities located at http://www.canuck.com/~thivier1/software.html. If there's anything you can't get SEARCH.EXE to do when making Web Pages, please let me know. OTHER FEATURES * Inside SEARCH.EXE, if you click on a particular JPEG file you will see the image dimensions of the file shown. * SEARCH.EXE can be used to produce a listing of all files matching a pattern in a directory and its sub-directories. You can limit the listing to files that contain a string inside them. Of course this includes comments inside of JPEG files. * SEARCH.EXE will decode JPEG files from saved uuencoded articles off the UseNet. Unlike most decoders SEARCH.EXE will read information such as the "Subject" line and will store this information in the JPEG file. This information can be used to have SEARCH.EXE organize your pictures into logical groups. * Without running another program, you can preview GIF images inside of SEARCH.EXE. As well, you can double click on any file and launch the associated program to view/edit that file. * You can view the comments stored inside a JPEG file inside SEARCH.EXE. If you used SEARCH.EXE to decode the picture, you can see information such as who posted the picture. Planned Features These are features I would like to implement if I get feedback on their usefullness. * Provide a user friendly interface for customizing a site. * Provide some canned picture layouts that users can select from, instead of always having to write their own if they want something different than the default. * Provide an easy built-in way to package files to be uploaded to a UNIX box. * Allow finer control over the size of GIF files created. * Let the user choose between GIF and JPEG format for in-line images. * Allow the user to use GIF files as anchor files. Program Stability This program still has bugs that I am working out. However, it seems to work OK for me and other users. Remeber you are using my program at your own risk. There is no warranty. Obtaining the Program If you are viewing this document on the Web, just load this anchor to disk and follow the installation procedures later in this file. Otherwise you should go to http://www.canuck.com/~thivier1/search.html to view the on-line version of this document or mail me at thivier1@freenet.calgary.ab.ca or thivier1@canuck.com. Legal Issues and Credits OWNERSHIP SEARCH(c) 1995 The Picture Page Generator Written by Robert Thivierge All rights reserved by Robert Thivierge Any attempt by a person other than myself to reverse compile, sell, or to represent the program as their own is prohibited. You may give a copy of the the program to someone else free of charge, provided you include all the files you received yourself. They then should notify me of receipt of it. However, any person or organization may distribute my program as freeware. They may charge a fee for the service of distribution (such as on-line charges, charge for distribution media, etc...). An acceptable form of distribution is including my program on CD-ROMs containing freeware/shareware, where there is a charge for the CD-ROM. However, it must be understood that they are not selling my program. And absolutely nobody, but me, may imply or suggest that they authored this program or that it is their property. I must always be given full credit. FREEWARE STATUS This program is freeware. I do not require financial payment for use of this product. Since users benefit from my time I think its fair to ask for some feedback. I like to know everytime someone gets my software and every time someone uses it for the first time. I also like suggested improvements, and friendly constructive criticism. I also appreciate being sent the URLs of sites made with the program. There is a special form to collect user responses, located at http://www.canuck.com/~thivier1/survey.html. You are always encouraged to let me know by e-mail what you're doing with and how its going with my program at thivier1@freenet.calgary.ab.ca or thivier1@canuck.com. Remember, one of my main rewards for making this program is seeing sites made with it. CREDITS * This software is based in part on the work of the Independent JPEG Group. They are kind enough to allow programmers to use their code library without financial charge. * The Graphics Interchange Format(C) is the Copyright property of CompuServe Incorporated. GIF(SM) is a Service Mark property of CompuServe Incorporated. * The actual compression method used in GIF is copywrited by Unisys Corporation. I thank them for allowing freeware authors to use their compression method without obtaining a license or paying royalties. See the Unisys FAQ on GIF for further details. * The tabbed dialogs in SEARCH.EXE were made with the source code for TabDlg.DLL. TabDlg.DLL is Copyright (c) 1994 Edward McCreary DISCLAIMER Use my program at your own risk. There are bugs I know of, there are bugs I don't know of. I assume no liability for any losses incurred by use of my program. I myself half accidently overwritten files with SEARCH.EXE. So, if I can loose stuff, you can too. System Requirements * Operating System: It was designed for Windows 3.1. Users have also run it on Windows 95 and Windows NT OK. * Memory: The amount required is semi-proportional to the size of the largest JPEG picture you wish to compress. The amount used increases greatly when you use Pattern Match Pages. Installation Procedures To install, do the following: 1. Make a directory for the program (such as C:\SEARCH). It is very important that you have a directory set aside exclusively for SEARCH.EXE. Never use the same directory for the program that you use for your Web Site. 2. Copy the ZIP File into it. 3. Unzip it with PKUNZIP or a compatible program. 4. Make sure all the files are in the same directory, with no other files present. Never use this directory to put your pictures or HTML files in. 5. Double click on SEARCH.EXE in the File Manager or create an icon for it in the Program Manager. To create an icon in the Program Manager, simply drag the file from the File Manager to the Program Manager. 6. Click on the "Settings" button and make sure they are all as you wish. A Picture of SEARCH.EXE If you are viewing this document on the web you can view a picture of SEARCH.EXE running. Known Bugs Please tell me of any bugs not on this list. 1. Clicking on the program while it's busy can cause it to crash. Let me know if this happens. I have reduced the frequency of this error. If I can find out under exactly what circumstances it happens, I may be able to fix it. 2. Fixed! - There should no longer be screen fuzz when you are writing GIF files out. This problem used to occur if the JPEG file was corrupt. I beleive I fixed this problem. Contacting the Author You are welcome to contact me with your comments, suggestions, and bug reports at either thivier1@freenet.calgary.ab.ca or thivier1@canuck.com. Visit my Home Page at http://www.canuck.com/~thivier1